﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>SoundSetVolume - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The SoundSetVolume function changes a volume setting of a sound device." />
<meta name="ahk:equiv-v1" content="lib/SoundSet.htm" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>SoundSetVolume</h1>

<p>更改声音设备的音量设置.</p>

<pre class="Syntax"><span class="func">SoundSetVolume</span> NewSetting <span class="optional">, Component, Device</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>NewSetting</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a>, <a href="../Concepts.htm#numbers">整数</a>或<a href="../Concepts.htm#numbers">浮点数</a></p>
    <p>一个包含 -100 和 100(包含的) 之间的百分数的字符串. 如果这个数字以加号或减号开头, 则将 <u>当前设置</u> 往上或往下调指示的数量. 否则, 此设置将被明确地设置为 <em>NewSetting</em> 表示的级别.</p>
    <p>如果百分数以减号开头或无符号开头, 则不需要用引号括起来.</p>
  </dd>

  <dt>Component</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a>或<a href="../Concepts.htm#numbers">整数</a></p>
    <p>如果为空或省略, 则更改主音量设置. 否则, 指定组件的显示名称和/或索引. 例如, <code>1</code>, <code>"Line in"</code> 或 <code>"Line in:2"</code>.</p>
    <p>有关详情, 请参阅 <a href="Sound.htm#component">Component (Sound 函数)</a>.</p>
  </dd>

  <dt>Device</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a>或<a href="../Concepts.htm#numbers">整数</a></p>
    <p>如果为空或省略, 则它默认为系统的默认回放设备(不一定是设备 1). 否则, 指定设备的显示名称和/或索引. 例如, <code>1</code>, <code>"Speakers"</code>, <code>"Speakers:2"</code> 或 <code>"Speakers (Example HD Audio)"</code>.</p>
    <p>有关详情, 请参阅 <a href="Sound.htm#device">Device (Sound 函数)</a>.</p>
  </dd>

</dl>

<h2 id="Error_Handling">错误处理</h2>
<p>如果无法找到设备或组件, 或组件不支持此控制类型, 则抛出 <a href="Error.htm#TargetError">TargetError</a>. 否则失败时, 抛出 <a href="Error.htm#OSError">OSError</a>.</p>

<h2 id="Remarks">备注</h2>
<p>调整音量的另一种方法是让脚本发送音量控制按键来改变整个系统的主音量, 如下例所示:</p>
<pre>Send "{Volume_Up}"  <em>; 增加 1 个音程的主音量(通常为 5%).</em>
Send "{Volume_Down 3}"  <em>; 降低 3 个音程的主音量.</em>
</pre>
<p>要发现系统上安装的声音设备的功能 -- 比如名称和可用的组件 -- 请运行这个<a href="Sound.htm#ExSoundcard">声卡分析脚本</a>.</p>
<p>SoundSetVolume 在更改音量级别时会尝试保持现有的平衡.</p>
<p>使用 <a href="SoundGetVolume.htm">SoundGetVolume</a> 来获取当前音量设置.</p>

<h2 id="Related">相关</h2>
<p><a href="Sound.htm">Sound 函数</a></p>

<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a class="ex_number" href="#ExBasic"></a> 将主音量设置为百分之 50. 引号可以省略.</p>
<pre>SoundSetVolume "50"</pre>
<pre>SoundSetVolume 50</pre>
</div>

<div class="ex" id="ExPlus">
<p><a class="ex_number" href="#ExPlus"></a> 将主音量增加百分之 10. 引号 <u>不能</u> 省略.</p>
<pre>SoundSetVolume "+10"</pre>
</div>

<div class="ex" id="ExMinus">
<p><a class="ex_number" href="#ExMinus"></a> 将主音量减小百分之 10. 引号可以省略.</p>
<pre>SoundSetVolume "-10"</p></pre>
<pre>SoundSetVolume -10</pre>
</div>

<div class="ex" id="ExMic">
<p><a class="ex_number" href="#ExMic"></a> 将麦克风录音音量增加百分之 20.</p>
<pre>SoundSetVolume "+20", , "Microphone"</pre>
</div>

</div>
</body>
</html>